OpenEdge Development:<br />Progress Dynamics Administration Site Data Dump and Load utilities architecture

The Site Data Dump and Load utilities are driven by a configuration file (dumpconfig.txt) that is stored in a.d text (Progress dump file) format in the first sitedatadump directory found in the sessions PROPATH. This file defines a list of dump programs, load programs, data files, and site numbers to support the dumping and loading of site-specific data. The sitedatadump directory must exist and must contain a valid dumpconfig.txt file for this tool to work.

The dump utility (dcusitedatadump.p) reads the configuration file to derive a list of dump programs to run and the site numbers for which data are to be dumped.

The dump utility runs the specified dump programs, which export the data to .d files that are to be read during the later import phase.

Note: You can hook the dump utility into the DCU so the data is automatically dumped during the DCU upgrade process.

The load utility (dcusitedataload.p) then reads the configuration file to derive a list of load programs to run.

The load utility runs the specified load programs to read the data dumped by the dump utility and import it back into the Repository.

Note: As with the dump utility, you can hook the load utility into the DCU so the data is automatically loaded during the DCU upgrade process.

The dump and load programs called by these utilities are partly user-defined procedures. These procedures must adhere to a certain standard described in the following sections. Most of the code in these programs comes from standard include files. You must add only the small pieces of information needed to specialize the dump or load program for a particular table.

Three sets of default dump and load programs have been specifically written to support dumping and loading the contents of the following framework tables:

gsm_menu_structure_item

gsm_toolbar_menu_structure

gsm_object_menu_structure

To run the Site Dump and Load utilities interactively without the DCU, Progress Dynamics provides a utility program (sitedatadmpload.w) that displays a simple GUI for you to invoke each dump or load utility as you require.